IdProo
IdProo Docs

Modul: Master Data — API — Permissions
Versi 1.0
Tanggal 21 April 2026
Aplikasi IdProo Admin
Audiens Administrator

Dalam artikel ini

  1. Menampilkan Daftar Permissions
  2. Menambahkan Permission
  3. Mencari Permission
  4. Preview Informasi Permission
  5. Mengubah Permission
  6. Menghapus Permission
  7. Import / Export Permissions
  8. Ringkasan Alur
  9. Solusi dan Tindakan Selanjutnya

1. Menampilkan Daftar Permissions

Halaman Permissions dapat diakses melalui navigasi: Master → API → Permissions.

Halaman ini menampilkan daftar seluruh permission API yang telah terdaftar dalam sistem.

screenshot-412-permissions-list

Gambar 1: Halaman Permissions menampilkan daftar permission dengan kolom Name dan Created at.

Kolom yang tersedia pada tabel Permissions:

Kolom Keterangan
Name Nama permission yang dapat diklik untuk melihat detail informasi
Created at Tanggal dan waktu data permission dibuat

Saat kursor diarahkan ke baris data, ikon Edit (✏) dan Delete (🗑) akan muncul di sebelah kanan baris tersebut.

2. Menambahkan Permission

Untuk menambahkan permission baru, klik tombol + New permission di pojok kiri atas tabel.

screenshot-413-new-permission-button

Gambar 2: Tombol + New permission untuk menambahkan permission baru.

Panel Create new permission akan terbuka di sisi kanan layar dengan form yang perlu diisi.

screenshot-414-create-permission-panel

Gambar 3: Panel Create new permission dengan field Name (wajib) dan tombol Save serta Cancel.

Form Create new permission terdiri dari:

Field Keterangan
Name Nama permission (wajib diisi)

Langkah-langkah menambahkan permission:

  1. Klik tombol + New permission.
  2. Isi field Name dengan nama permission yang diinginkan.
  3. Klik Save untuk menyimpan data.
  4. Klik Cancel untuk membatalkan.

Setelah data berhasil disimpan, notifikasi hijau "Data saved successfully" akan muncul di bagian atas layar.

screenshot-415-data-saved-notification

Gambar 4: Notifikasi "Data saved successfully" yang muncul setelah permission berhasil ditambahkan.

Tips: Field Name bersifat wajib diisi. Pastikan nama permission jelas dan deskriptif agar mudah diidentifikasi saat digunakan dalam konfigurasi akses API.

3. Mencari Permission

Untuk mencari permission tertentu, gunakan kolom pencarian yang tersedia di bagian kanan atas tabel.

screenshot-416-search-permission

Gambar 5: Hasil pencarian permission dengan kata kunci "new permission" menampilkan data yang sesuai, lengkap dengan informasi pagination (1 - 1 of 1).

Langkah-langkah mencari permission:

  1. Klik kolom Search di bagian kanan atas tabel.
  2. Ketikkan kata kunci nama permission yang ingin dicari.
  3. Sistem akan menampilkan hasil yang sesuai secara otomatis.

Catatan: Pencarian bersifat dinamis dan akan memfilter data sesuai kata kunci yang dimasukkan. Klik tombol ✕ di kolom pencarian untuk menghapus filter dan menampilkan kembali seluruh data.

4. Preview Informasi Permission

Untuk melihat detail informasi permission, arahkan kursor ke baris data hingga ikon Edit dan Delete muncul, lalu klik Name pada baris yang diinginkan.

screenshot-417-permission-row-hover

Gambar 6: Baris permission saat kursor diarahkan menampilkan ikon Edit (✏) dan Delete (🗑) di sisi kanan.

Panel detail akan terbuka di sisi kanan layar menampilkan seluruh informasi permission.

screenshot-418-permission-detail-panel

Gambar 7: Panel detail permission menampilkan Created, Created by, Last modified, dan Last modified by.

Informasi yang ditampilkan pada panel detail permission:

Field Keterangan
Created Tanggal dan waktu permission dibuat
Created by Nama lengkap dan email pengguna yang membuat data
Last modified Tanggal dan waktu terakhir data diubah
Last modified by Nama lengkap dan email pengguna yang terakhir mengubah data

Catatan: Klik tombol Close untuk menutup panel detail dan kembali ke halaman daftar Permissions.

5. Mengubah Permission

Untuk mengubah data permission, klik ikon Edit (✏) yang muncul saat kursor diarahkan ke baris data.

screenshot-419-edit-icon-tooltip

Gambar 8: Ikon Edit (✏) dengan tooltip "Edit" yang muncul saat kursor diarahkan ke baris permission.

Panel Edit permission akan terbuka di sisi kanan layar menampilkan form dengan data yang sudah terisi sebelumnya.

screenshot-420-edit-permission-panel

Gambar 9: Panel Edit permission dengan field Name yang dapat diubah.

Form Edit permission terdiri dari:

Field Keterangan
Name Nama permission (wajib diisi)

Langkah-langkah mengubah permission:

  1. Arahkan kursor ke baris permission yang ingin diubah.
  2. Klik ikon Edit (✏) yang muncul di sisi kanan baris.
  3. Ubah nilai pada field Name sesuai kebutuhan.
  4. Klik Save untuk menyimpan perubahan.
  5. Klik Cancel untuk membatalkan.

6. Menghapus Permission

Sistem menyediakan dua cara untuk menghapus data permission: menghapus satu data atau menghapus beberapa data sekaligus.

6.1 Menghapus Satu Permission

Untuk menghapus satu permission, klik ikon Delete (🗑) yang muncul saat kursor diarahkan ke baris data.

screenshot-421-delete-icon-tooltip

Gambar 10: Ikon Delete (🗑) dengan tooltip "Delete" yang muncul saat kursor diarahkan ke baris permission.

Dialog konfirmasi akan muncul sebelum penghapusan dilakukan.

6.2 Menghapus Beberapa Permission Sekaligus

Untuk menghapus beberapa permission sekaligus, centang checkbox pada baris-baris yang ingin dihapus, kemudian klik tombol Delete item (n) yang muncul di toolbar atas tabel.

screenshot-422-bulk-delete-selection

Gambar 11: Dua permission dipilih dengan checkbox dan tombol "Delete item (2)" aktif di toolbar.

Dialog konfirmasi akan muncul untuk memastikan penghapusan data.

screenshot-423-delete-confirmation-dialog

Gambar 12: Dialog konfirmasi "Delete Permissions" dengan pesan "Are you sure to delete this Permissions?", opsi "Delete permanently", serta tombol Cancel dan Delete.

Setelah dikonfirmasi, notifikasi hijau "Data deleted successfully" akan muncul.

screenshot-424-data-deleted-notification

Gambar 13: Notifikasi "Data deleted successfully" yang muncul setelah permission berhasil dihapus.

Langkah-langkah menghapus permission:

  1. Arahkan kursor ke baris permission (untuk hapus satu), atau centang checkbox pada beberapa baris (untuk hapus banyak).
  2. Klik ikon Delete (🗑) atau tombol Delete item (n).
  3. Dialog konfirmasi Delete Permissions akan muncul dengan pesan: "Are you sure to delete this Permissions?"
  4. Pastikan opsi Delete permanently telah dicentang jika ingin penghapusan bersifat permanen.
  5. Klik Delete untuk mengonfirmasi penghapusan.
  6. Klik Cancel untuk membatalkan.

⚠️ Perhatian: Jika opsi Delete permanently dicentang, data permission akan dihapus secara permanen dari sistem dan tidak dapat dipulihkan. Pastikan permission yang akan dihapus tidak sedang digunakan dalam konfigurasi scope atau akses API lainnya.

7. Import / Export Permissions

Fitur import dan export dapat diakses melalui menu OPTION (⋯) yang tersedia di bagian kanan atas tabel.

7.1 Import Permissions

Fitur import memungkinkan Administrator untuk menambahkan data permission secara massal melalui file Excel.

screenshot-425-option-menu-button

Gambar 14: Tombol menu OPTION (⋯) di bagian kanan atas tabel Permissions.

screenshot-426-option-menu-open

Gambar 15: Menu OPTION terbuka menampilkan pilihan Refresh, Import, dan Export.

Klik Import untuk membuka dialog import data.

screenshot-427-import-data-dialog

Gambar 16: Dialog "Import data" dengan area Drag & Drop atau Browse untuk memilih file, format yang didukung (XLS/XLSX), serta tombol Download untuk mengunduh Template example.

screenshot-428-file-browser-import

Gambar 17: Browser file menampilkan file "Import API Permission" yang dipilih untuk diunggah.

Setelah file dipilih dan proses import dimulai, notifikasi biru akan muncul.

screenshot-429-importing-notification

Gambar 18: Notifikasi biru "Importing data..." yang muncul saat proses import berjalan di latar belakang dengan pesan "Process runs in the background. Open notification to see details."

Langkah-langkah import permissions:

  1. Klik tombol OPTION (⋯) di bagian kanan atas tabel.
  2. Pilih Import dari menu dropdown.
  3. Dialog Import data akan terbuka.
  4. Unggah file dengan cara Drag & Drop atau klik Browse untuk memilih file dari perangkat.
  5. Pastikan file berformat XLS atau XLSX.
  6. Klik Open pada browser file untuk mengonfirmasi pilihan.
  7. Proses import akan berjalan di latar belakang. Notifikasi biru "Importing data..." akan tampil.
  8. Buka notifikasi untuk memantau status proses import.

Tips: Unduh Template example yang tersedia di dialog Import untuk memastikan format dan struktur kolom file sesuai dengan kebutuhan sistem. Nama file template yang disediakan: Import API Permission.

7.2 Export Permissions

Fitur export memungkinkan Administrator untuk mengunduh data permission dalam format Excel.

screenshot-430-option-menu-export

Gambar 19: Menu OPTION terbuka dengan opsi Export dalam kondisi aktif.

Klik Export untuk membuka dialog export data.

screenshot-431-export-data-dialog

Gambar 20: Dialog "Export data" dengan pilihan "This page" (dipilih) atau "All page", serta tombol Cancel dan Export.

screenshot-432-save-as-dialog

Gambar 21: Dialog Save As sistem dengan nama file "ApiPermissions-20260421024429177" dalam format Microsoft Excel Worksheet.

screenshot-433-download-complete

Gambar 22: Browser menampilkan notifikasi unduhan "ApiPermissions-20260421024..." telah selesai (5.0 KB • Done).

Langkah-langkah export permissions:

  1. Klik tombol OPTION (⋯) di bagian kanan atas tabel.
  2. Pilih Export dari menu dropdown.
  3. Dialog Export data akan terbuka dengan dua pilihan:
    • This page — hanya mengekspor data pada halaman yang sedang ditampilkan.
    • All page — mengekspor seluruh data permission.
  4. Pilih opsi yang diinginkan, kemudian klik Export.
  5. Dialog Save As akan muncul dengan nama file otomatis: ApiPermissions-YYYYMMDDHHMMSSMMM.
  6. Tentukan lokasi penyimpanan, lalu klik Save.
  7. File Excel akan diunduh dan notifikasi Done akan muncul di browser.

Catatan: Nama file hasil export mengikuti format ApiPermissions-YYYYMMDDHHMMSSMMM.xlsx, dengan bagian angka merepresentasikan tanggal dan waktu export dilakukan.

8. Ringkasan Alur

[Halaman Permissions]
        |
        |--- [Tambah] --> Klik "+ New permission"
        |                       |
        |                       +--> Isi Name* (wajib)
        |                       +--> Klik Save --> "Data saved successfully"
        |
        |--- [Cari] --> Ketik kata kunci di kolom Search
        |                       |
        |                       +--> Hasil difilter otomatis
        |
        |--- [Preview] --> Klik Name / hover baris
        |                       |
        |                       +--> Panel detail terbuka (Created,
        |                            Created by, Last modified,
        |                            Last modified by)
        |
        |--- [Edit] --> Hover baris --> Klik ikon Edit (✏)
        |                       |
        |                       +--> Panel "Edit permission" terbuka
        |                       +--> Ubah Name --> Klik Save
        |
        |--- [Hapus] --> Satu: Hover baris --> Klik ikon Delete (🗑)
        |             --> Banyak: Centang checkbox --> Delete item (n)
        |                       |
        |                       +--> Dialog: "Delete Permissions"
        |                       +--> Centang "Delete permanently"
        |                       +--> Klik Delete --> "Data deleted successfully"
        |
        |--- [Import] --> Klik OPTION (⋯) --> Import
        |                       |
        |                       +--> Upload file XLS/XLSX
        |                       +--> Proses berjalan di background
        |
        |--- [Export] --> Klik OPTION (⋯) --> Export
                                |
                                +--> Pilih This page / All page
                                +--> Klik Export --> Save As
                                +--> File: ApiPermissions-YYYYMMDDHHMMSSMMM.xlsx

9. Solusi dan Tindakan Selanjutnya

Situasi Kemungkinan Penyebab Tindakan
Tombol Save tidak merespons saat menambah/mengedit Field Name belum diisi Pastikan field Name telah terisi sebelum menyimpan
Data tidak muncul setelah pencarian Kata kunci tidak sesuai atau data belum ada Periksa ejaan kata kunci; coba cari nama permission secara lengkap atau sebagian
Permission tidak dapat dihapus Data masih digunakan dalam konfigurasi scope atau akses API Pastikan permission tidak sedang digunakan sebelum menghapus
Data terhapus secara permanen tidak dapat dipulihkan Opsi Delete permanently dicentang saat konfirmasi Hati-hati saat mengonfirmasi hapus; data yang dihapus permanen tidak bisa dikembalikan
Proses import tidak berjalan Format file tidak didukung Pastikan file berformat XLS atau XLSX sesuai template yang disediakan
File import gagal diproses Struktur kolom file tidak sesuai Unduh dan gunakan Template example (Import API Permission) dari dialog Import sebagai acuan
Export menghasilkan file kosong Tidak ada data pada halaman yang dipilih Pilih opsi All page atau pastikan ada data di halaman aktif
Data yang baru diimport tidak muncul di tabel Proses import masih berjalan di background Buka notifikasi untuk memantau status, lalu klik Refresh setelah selesai

Dokumen ini dibuat untuk keperluan panduan internal Administrator aplikasi IdProo.

© 2026 IdProo — Hak Cipta Dilindungi